/*
 * $Id: EmailService.java 3 2011-12-26 07:48:43Z forwardly@hotmail.com $
 * 
 * Copyright (c) 2001-2008 Accentrix Company Limited. All Rights Reserved.
 * 
 * Accentrix Company Limited. ("Accentrix") retains copyright on all text, source
 * and binary code contained in this software and documentation. Accentrix grants
 * Licensee a limited license to use this software, provided that this copyright
 * notice and license appear on all copies of the software. The software source
 * code is provided for reference purposes only and may not be copied, modified 
 * or distributed.
 * 
 * THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS," WITHOUT ANY WARRANTY OF
 * ANY KIND UNLESS A SEPARATE WARRANTIES IS PURCHASED FROM ACCENTRIX AND REMAINS
 * VALID.  ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
 * INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 * PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. ACCENTRIX SHALL NOT BE LIABLE
 * FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING OR MODIFYING THE
 * SOFTWARE OR ITS DERIVATIVES.
 * 
 * IN NO EVENT WILL ACCENTRIX BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR
 * FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
 * HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE
 * USE OF OR INABILITY TO USE SOFTWARE, EVEN IF ACCENTRIX HAS BEEN ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGES.
 */
package com.lightsaber.trade.as.service.email;

import java.util.Map;

public abstract class EmailService {

    /**
     * send email
     * 
     * @param emailType
     *            determine what email template will be used
     * @param subject
     *            the subject of mail
     * @param values
     *            the variable value will be used generate the email content
     * @param from
     *            the email sender
     * @param tos
     *            the email receivers
     * @throws Exception
     */
    public final void sendEmail(final String emailType, final String subject,
            final Map<String, String> values, final String from, final String[] tos)
            throws Exception {

        String content = getContent(emailType, values);

        doSendEmail(from, tos, subject, content);
    }

    /**
     * 
     * @param emailType
     *            determine what email template will be used
     * @param values
     *            the variable value will be used generate the email content
     * @return
     */
    protected abstract String getContent(String emailType, Map<String, String> values);

    /**
     * 
     * @param from
     *            the email sender
     * @param tos
     *            the email receivers
     * @param subject
     *            the subject of mail
     * @param content
     *            the content of mail
     * @throws Exception
     */
    protected abstract void doSendEmail(String from, String[] tos, String subject, String content)
            throws Exception;

}
